Developer --> Technical Publications
PATHMac OS 8 Developer Documentation > Files > Navigation Services >

Programming With Navigation Services 1.1

Configuration Option Constants

In the dialogOptionFlags field of the structure of type NavDialogOptions , you can specify values for Navigation Services dialog box configuration options. Use the constants defined by the NavDialogOptionFlags data type to specify these values.

enum NavDialogOptionFlags {
    kNavDefaultNavDlogOption    = 0x000000E4,/* use default options */
    kNavNoTypePopup             = 0x00000001,/* don't show type pop-up*/
    kNavDontAutoTranslate       = 0x00000002,/* don't auto-translate */
    kNavDontAddTranslateItems   = 0x00000004,/* don't add translation
                                                choices */
    kNavAllFilesInPopup         = 0x00000010,/* add All Files
                                                menu item */
    kNavAllowStationery         = 0x00000020,/* allow stationery files */
    kNavAllowPreviews           = 0x00000040,/* allow previews */
    kNavAllowMultipleFiles      = 0x00000080,/* allow mult. selection*/
    kNavAllowInvisibleFiles     = 0x00000100,/* show invisible objects*/
    kNavDontResolveAliases      = 0x00000200,/* don't resolve aliases */
    kNavSelectDefaultLocation   = 0x00000400,/* make default location
                                                the browser selection */
    kNavSelectAllReadableItem   = 0x00000800/* make All Readable Items
                                                default selection */
};

Constant Descriptions

kNavDefaultNavDlogOptions
Tells Navigation Services to use default configuration options. These default options are

kNavNoTypePopup
Tells Navigation Services not to display the Show pop-up menu in the Open dialog box or the Format pop-up menu in the Save dialog box.
kNavDontAutoTranslate
Tells Navigation Services that your application will handle file translation. Normally a file chosen in an Open dialog box that requires translation is automatically translated. Navigation Services informs your application that a file needs translating by setting the translationNeeded field of the structure NavReplyRecord to true . A translation specification array, specified in the fileTranslation field of the NavReplyRecord structure, contains the associated translation specification records. When you set the kNavDontAutoTranslate flag, your application is responsible for translation, either by calling the function NavTranslateFile or by performing the translation itself. For more information, see Translating Files on Open.
kNavDontAddTranslateItems
Tells Navigation Services not to display file translation options in the Show pop-up menu. For more information, see Translating Files on Open.
kNavAllFilesInPopup
Tells Navigation Services to add a pop-up menu item called All Documents, so the user can see a display of all files in the current directory.
kNavAllowStationery
Tells Navigation Services to display a Stationery Option command in the Format pop-up menu of Save dialog boxes, so users can choose to save a file as a document or as stationery. This is a default option. For more information, see Providing File Format Options.
kNavAllowPreviews
Tells Navigation Services to provide previews, when available, of selected files. This is a default option. See also Drawing Custom Previews .
kNavAllowMultipleFiles
Tells Navigation Services to allow users to select and open multiple files in the browser list by shift-clicking or using the Select All command. If you don't specify this constant, users can select multiple files for drag-and-drop operations, but the default button (normally titled Open) is disabled when multiple items are selected.
kNavAllowInvisibleFiles
Tells Navigation Services to show invisible file objects in the browser list.
kNavDontResolveAliase s
Tells Navigation Services not to resolve any alias selected by the user. If the user selects an alias with this option set, the file system specification returned by Navigation Services designates the alias file instead of its referenced original. If you specify this constant before calling the function NavPutFile , Navigation Services returns a result code of paramErr (-50).
kNavSelectDefaultLocation
Tells Navigation Services to select the default location in the browser list. By default, Navigation Services will open the browser list with the default location displayed, not selected. For example, if you define the System Folder as the default location and specify the kNavSelectDefaultLocation constant, the System Folder appears as the current selection in the browser list. Without this constant, the browser list displays the contents of the System Folder.
kNavSelectAllReadableItem
Tells Navigation Services to show All Readable Documents as the default selection in the Show pop-up menu when the Open dialog box is first displayed. If you do not specify this constant, Navigation Services shows the All <AppName> Documents menu item as the default selection in the Show pop-up menu when the Open dialog box is first displayed.
© 1998 Apple Computer, Inc. – (Last Updated 23 Nov 98)

Previous | Back Up One Level | Next |